feat: Kaapi Agentic Chatbot Flow & State Management by Ayush8923 · Pull Request #1300 · ProjectTech4DevAI/kaapi-backend

Ayush8923 · 2026-10-21T18:50:05Z

Issue

Closes #1230 #1278

Summary

Added POST /chatbot/message, stateless chatbot endpoint; caller sends full message history each turn, gets back the updated transcript
Built ChatbotEngine using LangGraph + LangChain (ChatAnthropic), single-node graph handles one conversation turn
Added token-based history summarization: when history exceeds the token budget, older turns are compressed into a summary note before the model call
Wired chatbot model settings to existing Kaapi config system (config_id + optional config_version) so model, max tokens, and reasoning effort come from saved configs
Added langchain-anthropic dependency
Added two Alembic seed migrations (086, 087) for Anthropic text model configs
Added wiki docs for the chatbot module

Chatbot State Management Related Updates

chatbot conversation history is now stored on the server, the caller doesn't need to send the full history every time
create a session once (POST /chatbot/sessions), you'll get a session_id
send every message using that session_id (POST /chatbot/sessions/{session_id}/message), the server tracks history itself
on sending a message the API immediately returns 202; the bot's reply is processed in the background and POSTed to the caller webhook_url.
system prompt and config get locked while creating the session, the same settings stay throughout the conversation

Checklist

Before submitting a pull request, please ensure that you mark these task.

Ran fastapi run --reload app/main.py or docker compose up in the repository root and test.
If you've fixed a bug or added code that is tested and has test cases.

coderabbitai · 2026-10-21T18:50:13Z

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one): 1

ready-for-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

Source mode: Auto
Repository: ProjectTech4DevAI/kaapi-backend
Branch: feat/kaapi-chatbot-flow-v2
File: .coderabbit.yaml
Commit: 26f70a2
Layers: Repository YAML
Review profile: CHILL
Plan: Advanced
Run ID: c3ae2cef-d811-47ac-8e06-ca5213bc107d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-10-21T18:51:20Z

OpenAPI changes 🔴 3 breaking changes

Caution

Downstream consumers may need an update before merging.

Breaking changes · 3

	Method	Path	Change
🔴	`GET`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1]/items/key` response property for the response status `200`
🔴	`PATCH`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1: FeatureFlagPublic]/key` response property for the response status `200`
🔴	`POST`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1: FeatureFlagPublic]/key` response property for the response status `200`

Full changelog · 11

	Method	Path	Change
🔴	`GET`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1]/items/key` response property for the response status `200`
🔴	`PATCH`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1: FeatureFlagPublic]/key` response property for the response status `200`
🔴	`POST`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the `data/anyOf[subschema #1: FeatureFlagPublic]/key` response property for the response status `200`
🟢	`—`	`—`	a breaking change was detected but the version is still `0.5.0`
🟢	`GET`	`/api/v1/chatbot/sessions`	endpoint added
🟢	`POST`	`/api/v1/chatbot/sessions`	endpoint added
🟢	`POST`	`/api/v1/chatbot/sessions/{session_id}/message`	endpoint added
🟢	`DELETE`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the request property `key`
🟢	`GET`	`/api/v1/feature-flags`	added the enum value `CHATBOT` to the property `anyOf[subschema #1: FeatureFlag]/` of the `query` request parameter `key`
🟢	`PATCH`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the request property `key`
🟢	`POST`	`/api/v1/feature-flags`	added the new `CHATBOT` enum value to the request property `key`

_{main ↔ 77db2cd1 · generated by oasdiff}

codecov · 2026-10-21T19:05:28Z

Codecov Report

❌ Patch coverage is 99.82925% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
backend/app/services/chatbot/session.py	95.89%	3 Missing ⚠️

📢 Thoughts on this report? Let us know!

…kend into feat/kaapi-chatbot-flow-v2

feat(*): init chatbot flow

dbba788

Ayush8923 changed the title ~~feat: Kaapi Agentic Chatbot Flow- #1273~~ feat: Kaapi Agentic Chatbot Flow Oct 21, 2026

github-actions Bot changed the title ~~feat: Kaapi Agentic Chatbot Flow~~ feat(chatbot): Implement Stateless Chatbot Endpoint Oct 21, 2026

Ayush8923 self-assigned this Oct 21, 2026

Ayush8923 changed the title ~~feat(chatbot): Implement Stateless Chatbot Endpoint~~ feat: Kaapi Agentic Chatbot Flow Oct 21, 2026

Ayush8923 marked this pull request as ready for review October 21, 2026 18:59

Ayush8923 mentioned this pull request Oct 21, 2026

feat: Kaapi Agentic Chatbot Flow #1273

Closed

1 of 2 tasks

feat: Chatbot State Management (#1301)

e0130e8

Ayush8923 linked an issue Oct 21, 2026 that may be closed by this pull request

Chabot: Server-side chatbot state management #1278

Open

4 tasks

Ayush8923 changed the title ~~feat: Kaapi Agentic Chatbot Flow~~ feat: Kaapi Agentic Chatbot Flow & State Management Oct 21, 2026

Ayush8923 added 14 commits October 22, 2026 13:40

Merge branch 'main' into feat/kaapi-chatbot-flow-v2

0103f45

fix: test cases updates

8d9919c

Merge branch 'main' of https://github.com/ProjectTech4DevAI/kaapi-bac…

2584679

…kend into feat/kaapi-chatbot-flow-v2

fix: remove the unwanted migration

54c00ad

fix: few clenaups

00bbe9a

fix: cleanups and save collected fields in db

e9927df

fix: refinement system prompt

90a2cbd

fix: implement the state management api flow creation

e884d24

feat: added the feature flag

3e09675

chore: remove the unused code

c18a3a8

fix: few updates on the get request

440e5c8

fix: cleanups

f44ba82

fix: refactoring

daf4b92

Merge branch 'main' of https://github.com/ProjectTech4DevAI/kaapi-bac…

7d0b166

…kend into feat/kaapi-chatbot-flow-v2

Ayush8923 added the breaking-change-approved Reviewer-acknowledged API breaking change label Oct 24, 2026

Ayush8923 added 2 commits October 24, 2026 16:46

fix: update test cases

ab34262

fix: cleanups

26f70a2

Navigation Menu

Repository navigation

feat: Kaapi Agentic Chatbot Flow & State Management - #1300

feat: Kaapi Agentic Chatbot Flow & State Management#1300
Ayush8923 wants to merge 18 commits into
mainfrom
feat/kaapi-chatbot-flow-v2

Ayush8923 commented Oct 21, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Oct 21, 2026 •

edited

Loading

Review skipped

Uh oh!

github-actions Bot commented Oct 21, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Oct 21, 2026 •

edited

Loading

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

Ayush8923 commented Oct 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue

Summary

Chatbot State Management Related Updates

Checklist

Uh oh!

coderabbitai Bot commented Oct 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

github-actions Bot commented Oct 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

OpenAPI changes 🔴 3 breaking changes

Uh oh!

codecov Bot commented Oct 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Ayush8923 commented Oct 21, 2026 •

edited

Loading

coderabbitai Bot commented Oct 21, 2026 •

edited

Loading

github-actions Bot commented Oct 21, 2026 •

edited

Loading

codecov Bot commented Oct 21, 2026 •

edited

Loading